home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
Especial Multimedia
/
Especial Multimedia.iso
/
Multimed
/
Prg
/
TBKOPEN.ZIP
/
README.TXT
< prev
next >
Wrap
Text File
|
1997-09-14
|
2KB
|
58 lines
**Generic ToolBook Open Dialog Box**
TBKOPEN.DLL is a Windows Dynamic Link Library (DLL) that adds
generic open dialog box functionality to ToolBook. This document
provides the information necessary to use the DLL from OpenScript,
ToolBook's programming language.
**linkDLL Statement**
You must link to the DLL with the following control structure:
linkDLL "tbkopen.dll"
STRING OpenDlg(STRING, STRING, STRING, STRING)
end linkDLL
**Return Value**
OpenDlg returns a string that contains the fully qualified
path name of the file the user chooses to open. If the user
dismisses the dialog box without choosing a file, OpenDlg
returns NULL, and sysError is set to -1.
OpenDlg does not open the selected file. It simply returns the fully
qualified path name of the file the user chooses.
**Parameters**
OpenDlg requires four string parameters. The first parameter is
the search path, the second parameter is the file specification,
the third parameter is a prompt string that is displayed at the
top of the dialog box (not on the caption bar), and the fourth
parameter is the dialog box caption.
If the first parameter is null, the current search directory is
used. If the second parameter is null, *.* is assumed.
The prompt string is blank if none is provided.
**Example**
[Put this handler in your book script]
to handle enterBook
linkDLL "tbkopen.dll"
STRING OpenDlg(STRING, STRING, STRING, STRING)
end linkDLL
end enterBook
[Put this handler in an object script]
to handle buttonUp
get OpenDlg("c:\lotus", "*.txt", "Please choose" && \
the text file you would like to open...", "Open")
openFile it
[more statements...]
end buttonUp
7/9/90
Jeff Day, Asymetrix Corporation
Updated 1/30/91